home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / disk / bss150.zip / BSS.DOC next >
Text File  |  1996-06-28  |  26KB  |  609 lines
  1. Bunch's String Search Utility   Copyright (c) 1993-1996 by David Bunch V1.50
  2. Usage:
  3.        BSS [switches] FILE.NAM,file2,etc STRING,string,etc
  4. switches:  (To create Documentation execute BSS /O=BSS.DOC /? )
  5.   /A  Treat all files as ASCII         /B  for BBS file type listing
  6.   /BEfore=MM/DD/YY or HH:MM:SS  Searches files after a certain DATE or TIME.
  7.   /C:# search for string starting in this column only
  8.   /D# String search DELIMITER          /E  EXACT matches only
  9.   /F  display FILES that match wild cards (no search string used or needed)
  10.   /FS display SUBTOTALS of SUBdir's    /FR display totals of ROOT dir's
  11.   /H=BLink, BOLD(default), Reverse, No highlighting, [],{},(),or ''
  12.   /I:ASHRE INCLUDE files with the following attribs (use /I:SH for all files)
  13.   /J  Print JUST strings that match,   /K:# sKip lines longer that # (134 def.)
  14.   /L:*?  wiLd search (the * & ? can be any 2 characters you wish to use)
  15.   /M=AND or /M=OR (default) or /M=NAND or /M=NOR
  16.   /MIN=# and /MAX=# (min/max file sizes to look at #=number of bytes)
  17.   /N  Print NAMES for non matches      /O=filename    OUTPUT to this file name
  18.   /P:# PAUSE after each screen         /R=filename    REDIRECT input of strings
  19.   /S  search all SUB directories, or /SN (no printing of directory names)
  20.   /SInce=MM/DD/YY or HH:MM:SS  Searches files after a certain DATE or TIME.
  21.   /T  output TOTAL matches only        /U  USE Dos standard wild carding
  22.   /W  WINDOW: [W=before,after] (ie. /W=5,6)
  23.   /X=file,file,etc  eXclude files      /?  Display additional information
  24.   /#=n or /#H=n Print line numbers (n = number of chars. to use)
  25. DISCLAIMER:
  26.     BSS is being distributed on an as-is-basis.  There is no warranty
  27.     of any kind.  The author is not responsible for any damages,
  28.     including lost profits or other incidental or consequential damage
  29.     that may result from the use of this program.
  30.  
  31. Some further info about switches:
  32.  
  33.     All switches are non case sensitive.  When more than 1 character is
  34.     needed for a switch only 2 characters need be entered.
  35.  
  36. /A    This will treat all files as ASCII.  Normally BSS will figure out
  37.     whether it is a binary file or not, but if it does not, try this
  38.     switch.  Be aware that you may get a lot of junk characters on your
  39.     display for binary files, because normally it will not even search
  40.     binary areas if it decides that it binary.  Use this with CAUTION.
  41.     Program turns of windowing if used in conjunction with this & issues
  42.     you a warning, but continues the search after you hit a return.  This
  43.     could cause a problem, in that you could be trying to look at too
  44.     many records than could fit into my 8K read buffer.  By using this
  45.     switch, the program always looks for "LF" character for the end of
  46.     record.
  47.     
  48. /B    This switch is primarily used for searching descriptions of BBS file
  49.     listings that span more than 1 line.  If a match is found when this
  50.     switch is active, the complete description of the file name will be
  51.     printed.  All the program does is look for a SPACE or TAB character
  52.     as the 1st character of a line to decide whether the description is
  53.     continued or not.  I chose this method because it was simply to
  54.     implement, & could have other uses for any file that has sections
  55.     of information starting with a non-blank character.  If used in
  56.     conjunction with the /M=A switch, it will print a match if all matches
  57.     are found anywhere in the description, not just on 1 line together.
  58.     If you are searching a BBS listing for the string "midi" & only wanted
  59.     a listing of the names that had those matches in it, use the /BN
  60.     switch. For example:
  61.     Searching a listing normally would print out this type of format
  62.  
  63. TEMHUMDX.ZIP    33568  07-29-92  Calculate temp/humidity for discomfort lvl.
  64. MIDVOL3.ZIP     39183  01-01-93  Collection of midi songs
  65. CATSP180.ZIP    94212  01-10-93  WAVE AND MIDI PLAYER FOR WIN-FEW OPTIONS
  66.  
  67.     By using the /BN switch you would only get
  68.  
  69. TEMHUMDX.ZIP
  70. MIDVOL3.ZIP
  71. CATSP180.ZIP
  72.  
  73.     If you used the switch /BF you would also get the file name that
  74.     it found them in.
  75.  
  76.     You will also get NO HILIGHTING if you use the /BF or /BN switch.
  77.  
  78.     If you find that this switch does not work on what you think is an
  79.     ASCII file, it probably found a line longer than 132 characters in it
  80.     & you can get around this by using /A switch in conjunction with this.
  81.  
  82. /C:#    Search for string starting in this column only.  Valid Column positions
  83.     start at 1 & go up from there.  You can enter "/C:0" if you like & it
  84.     will set it to 1.  The default position is 1.  This should work for
  85.     both ASCII & binary files.  If used in conjunction with the "/B",
  86.     "/WP", or "WR" position is offset from 1st character on the 1st line.
  87.  
  88. /D#    If you are looking for a string or strings that have a comma in them
  89.     just specify a character with this switch that is not in any of your
  90.     search strings.  The "/" or TAB character can not be used, but if you
  91.     used "/D" with no character following it, it will use the SPACE
  92.     character.
  93.     Examples:
  94.  
  95.     BSS *.* looking for this sentence,and this one
  96.  
  97.     This would search for 2 strings "looking for this sentence"
  98.     & "and this one".  If you add a space before or after the comma, it
  99.     will be included in search string.
  100.  
  101.     BSS /D" *.* Dec 1, 1992"Jan 2, 1993
  102.  
  103.     Would search for "dec 1, 1992" & "Jan 2, 1993"
  104.  
  105. /E    This changes the default setting of case insensitive search.  It will
  106.     check for exact case on searches.
  107.  
  108. /F    display FILES that match wild cards (no search string needed).  This
  109.     is handy if you are looking for a file on your disk & you only know
  110.     1 or more characters in the name.  When it finds a match, it will
  111.     display the 1st non-wild card name it found that matched & highlight it
  112.     accordingly.  It also displays the size, date, & time of each file.
  113.     For Example:
  114.  
  115.     BSS /F *S*.*E*
  116.  
  117.     This could find the file BSS.EXE.  Highlight the 1st "S" in "BSS" &
  118.     the 1st "E" in "EXE".  If you had entered *SS*.*E*, it would have
  119.     highlighted both "SS" 's.  If you use this in conjunction with /U
  120.     you will not get any highlighting.
  121.  
  122.  
  123. /FR    Instead of displaying subtotals of all directores, It displays totals
  124.     of each main ROOT directory & it's subdirectories in 1 subtotal.
  125.     Example:
  126.  
  127.     2,276,279  C:\
  128.     8,109,377  C:\DOS
  129.       717,983  C:\DSKMGR
  130.       293,555  C:\SBCD
  131.     3,561,194  C:\TEMP
  132.    32,619,128  C:\WINDOWS
  133.  
  134.  
  135. /FS    Display Subtotals of Subdirectories.
  136.     Example:
  137.  
  138.     2,276,279  C:\
  139.     8,109,377  C:\DOS
  140.       717,983  C:\DSKMGR
  141.       105,038  C:\SBCD
  142.        23,637  C:\SBCD\DRV
  143.       164,880  C:\SBCD\PLAYCD
  144.     3,186,417  C:\TEMP
  145.       374,777  C:\TEMP\TP
  146.    10,225,209  C:\WINDOWS
  147.    21,241,900  C:\WINDOWS\SYSTEM
  148.        55,296  C:\WINDOWS\TWAIN
  149.       944,147  C:\WINDOWS\TWAIN\SNAPPY
  150.       152,576  C:\WINDOWS\TWAIN\PHOTO
  151.  
  152. /G    This enables searching for 44 IBM graphics drawing characters starting
  153.     with ASCII character 180 decimal.
  154.  
  155. /H=BLink, BOld(default), Reverse, No highlighting
  156.     /H=BL    blink
  157.     /H=BO    bold
  158.     /H=R    reverse
  159.     /H=N    no highlighting
  160.  
  161.     /H=[]    enclose match in brackets, useful if outputting to a file
  162.        ()   or doing a print screen
  163.        <>
  164.        {}
  165.     An additional option that Tim Wilson requested was to enclose the match
  166.     in brackets.  I decided to make it a bit more flexible, so you can add
  167.     whatever characters you want before & after the match.  Just enter the
  168.     2 characters you want to use.  If you are not outputting this search
  169.     to a file, it will also use BOLD hilighting on the screen.
  170.  
  171.     This allows you to use the type of highlighting that you want, if you
  172.     do not like the default.
  173.  
  174. /I=ASHRE  The default file type to search thru are normal files.  This switch
  175.     allows you to look for or thru files with the following attributes set.
  176.     Archive, System, Hidden, Read-only.  You can enter these in any order,
  177.     but should be entered 1 behind the other with no other characters.  If
  178.     you want to look at all types of files, you only need enter "/I=SH".
  179.     This is because DOS does not check the ARCHIVE or READONLY bits in it's
  180.     Find 1st match call (INT 21h, service 4eh), so I decided to use these
  181.     a little differently.  If you set 1